/**
 * Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod
 * tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,
 * quis nostrud exercitation ullamco.
 * 
 * @author kilroy
 * @see Example2
 * @see http://wiki.ecipse.org
 * @deprecated Do not use this class, it's only to test formatting on. One two
 * three four five six seven eight nine ten.
 */
public class Example {
	/**
	 * Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod
	 * tempor incididunt ut labore et dolore magna aliqua.
	 * 
	 * @param first
	 *     the first param. Nullam nec ex vitae felis eleifend lacinia in in velit.
	 * @param second
	 *     a second apram. Curabitur commodo tortor vel sapien elementum, sit amet
	 *     varius eros varius.
	 * @param x
	 *     a third param. Pellentesque ac ipsum. Quisque ac nunc odioque id nunc
	 *     convallis nec mi.
	 * @throws Exception1
	 *     when the first thing happens. Nam nec sodales sem. Curabitur odio sem,
	 *     sodales ac lorem eget, pretium tincidunt ligula. Ut eget placerat justo.
	 * @throws OtherException
	 *     when some other thing happens. Duis feugiat ultricies magna, sit amet
	 *     sagittis nibh eleifend eu. Curabitur in egestas velit.
	 * @return Lorem consectetur adipiscing ut enim ad minim veniam, quis nostrud
	 * exercitation ullamco. Nullam nec ex vitae felis eleifend lacinia in in velit.
	 * @since 1.1.1
	 */
	void method1() {
	}

	/**
	 * Curabitur commodo tortor vel sapien elementum, sit amet varius eros varius.
	 * Morbi posuere ex sit amet lorem vestibulum pulvinar. In in sagittis urna,
	 * euismod tempus eros.
	 * 
	 * @param parameterOne
	 *     the first param.
	 *     <li>item1</li>
	 *     <li>item2</li>
	 *     <li>item3</li>
	 * @param theSecondParameter
	 *     the second param. <code>line1
	 * line2</code>
	 * @deprecated method1 should be used instead
	 */
	void method2() {
	}

	/**
	 * Curabitur rhoncus felis non elit malesuada, et gravida enim tempus. Morbi sit
	 * amet viverra est. Sed eu libero in mauris facilisis condimentum.
	 * 
	 * @see <a href="http://bugs.eclipse.org">bugzilla</a>
	 * @see method1
	 * @return
	 * @throws RuntimeException
	 *     Curabitur morbi sit amet viverra est. Sed eu libero in mauris facilisis
	 *     condimentum.
	 */
	void method3() {
	}

	/**
	 * @param argument
	 *     Integer diam sapien, interdum a dolor sit amet, vestibulum vehicula ante.
	 *     Mauris ultricies odio sit amet nunc laoreet, sed venenatis enim
	 *     efficitur.
	 * @throws e
	 *     Proin dignissim enim eu erat cursus fringilla.
	 *     <p>
	 *     Aliquam efficitur sed turpis ut cursus.
	 *     <p>
	 *     Nunc pharetra aliquam massa et sagittis.
	 * @param param
	 * 
	 *     <pre>
	 *     int i = 1234;
	 *     </pre>
	 * 
	 * @return Nunc ultricies neque eu elit porttitor, vel scelerisque metus
	 * accumsan. Curabitur dictum arcu magna, eget mattis lacus congue id.
	 * @gibberish invalid tag?
	 */
	void method5() {
	}

	/**
	 * Draws as much of the specified image as is currently available with its
	 * northwest corner at the specified coordinate (x, y). This method will return
	 * immediately in all cases, even if the entire image has not yet been scaled,
	 * dithered and converted for the current output device.
	 * <p>
	 * If the current output representation is not yet complete then the method will
	 * return false and the indicated {@link ImageObserver} object will be notified
	 * as the conversion process progresses.
	 *
	 * @param img
	 *     the image to be drawn
	 * @param x
	 *     the x-coordinate of the northwest corner of the destination rectangle in
	 *     pixels
	 * @param y
	 *     the y-coordinate of the northwest corner of the destination rectangle in
	 *     pixels
	 * @param observer
	 *     the image observer to be notified as more of the image is converted. May
	 *     be <code>null</code>
	 * @return <code>true</code> if the image is completely loaded and was painted
	 * successfully; <code>false</code> otherwise.
	 * @see Image
	 * @see ImageObserver
	 * @since 1.0
	 */
	public abstract boolean drawImage(Image img, int x, int y, ImageObserver observer);

}